AE CopyPaste v1.3 - Adobe After Effects panel
=============================================

A dockable panel with 5 buttons:
  - Copy        : copies the current comp frame to the clipboard
  - Paste       : pastes an image from the clipboard into the active comp as a new layer
                  (the image is saved in a "CopyPaste Images" folder next to your .aep project file)
  - Organize    : sorts project items into Images / Videos / Audio / Compositions / Pre-Comps / Solids / Others folders
  - Precompose  : pre-composes the selected layers and crops the new comp to their visible content and time span
                  (never larger than the original comp: anything outside the comp frame is cropped away;
                  track mattes and masks are respected - only the actually visible area is kept).
                  The new pre-comp is named after the layer (e.g. "Logo", or "Title +2" for 3 layers).
                  Alt+Click: UN-precompose the selected pre-comp layer (its layers return to the same place and time).
  - Clear Anim. : freezes the current look and removes all keyframes and expressions (effects are kept)

Requirements
------------
  - Adobe After Effects (tested on AE 2023, Windows 10/11)
  - Windows: PowerShell (built into Windows)
  - macOS: supported in the code but not yet tested

Installation
------------
1. Close After Effects.

2. Copy "AE CopyPaste.jsxbin" into the ScriptUI Panels folder:

   Windows:
   C:\Program Files\Adobe\Adobe After Effects <version>\Support Files\Scripts\ScriptUI Panels\

   macOS:
   /Applications/Adobe After Effects <version>/Scripts/ScriptUI Panels/

   (Replace <version> with your version, for example 2023.)
   If an older "AE CopyPaste.jsx" is already in that folder, delete it first,
   so the panel does not appear twice in the Window menu.

3. Start After Effects.

4. Allow scripts to write files (required for Copy and Paste):
   Windows: Edit > Preferences > Scripting & Expressions
   macOS:   After Effects > Settings > Scripting & Expressions
   Turn ON "Allow Scripts to Write Files and Access Network".

5. Open the panel: Window > AE CopyPaste.jsxbin
   Dock it anywhere you like.

Tips
----
  - Status messages also appear in the Info panel (Window > Info),
    which is useful when the panel is small.
  - Copy and Paste use the composition that is open in the Viewer,
    even when another panel (Project, Effect Controls...) is active.
  - Precompose crops to what is visible at the current time indicator,
    so place the playhead where the content is fully visible first.
  - Every action can be undone with a single Ctrl+Z (Cmd+Z).
  - Save your project before using Paste: pasted images go into the "CopyPaste Images"
    folder next to the project file, so they travel with the project. If the project is
    not saved yet, the panel offers to save it first.
  - Keep the "CopyPaste Images" folder with your project: the images are used as footage.
  - Un-precompose cannot carry over effects, masks, blend modes, track mattes, opacity,
    time remap or 3D applied to the pre-comp layer itself; you will be warned first.
